@terreno/admin-frontend 0.9.3 → 0.10.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.
@@ -0,0 +1,14 @@
1
+ import type { Api } from "@reduxjs/toolkit/query/react";
2
+ import React from "react";
3
+ interface AdminObjectPickerProps {
4
+ api: Api<any, any, any, any>;
5
+ routePath: string;
6
+ refModelName: string;
7
+ title: string;
8
+ value: string;
9
+ onChange: (value: string) => void;
10
+ errorText?: string;
11
+ helperText?: string;
12
+ }
13
+ export declare const AdminObjectPicker: React.FC<AdminObjectPickerProps>;
14
+ export {};
@@ -0,0 +1,128 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { Box, IconButton, Spinner, Text, TextField } from "@terreno/ui";
3
+ import { useCallback, useEffect, useMemo, useRef, useState } from "react";
4
+ const DISPLAY_FIELDS = ["name", "title", "email", "label", "displayName"];
5
+ const getDisplayValue = (item) => {
6
+ var _a;
7
+ for (const field of DISPLAY_FIELDS) {
8
+ if (item[field]) {
9
+ return String(item[field]);
10
+ }
11
+ }
12
+ return (_a = item._id) !== null && _a !== void 0 ? _a : String(item);
13
+ };
14
+ const getSecondaryText = (item, primaryField) => {
15
+ for (const field of DISPLAY_FIELDS) {
16
+ if (field !== primaryField && item[field]) {
17
+ return String(item[field]);
18
+ }
19
+ }
20
+ return undefined;
21
+ };
22
+ const getPrimaryField = (item) => {
23
+ for (const field of DISPLAY_FIELDS) {
24
+ if (item[field]) {
25
+ return field;
26
+ }
27
+ }
28
+ return "_id";
29
+ };
30
+ export const AdminObjectPicker = ({ api, routePath, refModelName, title, value, onChange, errorText, helperText, }) => {
31
+ var _a;
32
+ const [searchText, setSearchText] = useState("");
33
+ const [isOpen, setIsOpen] = useState(false);
34
+ const [isChanging, setIsChanging] = useState(false);
35
+ const [selectedDisplay, setSelectedDisplay] = useState("");
36
+ const debounceRef = useRef(null);
37
+ const [debouncedQuery, setDebouncedQuery] = useState("");
38
+ // Clear pending debounce on unmount
39
+ useEffect(() => {
40
+ return () => {
41
+ if (debounceRef.current) {
42
+ clearTimeout(debounceRef.current);
43
+ }
44
+ };
45
+ }, []);
46
+ const searchEndpointKey = `adminSearch_${refModelName}`;
47
+ const readEndpointKey = `adminSearchRead_${refModelName}`;
48
+ const enhancedApi = useMemo(() => {
49
+ return api.injectEndpoints({
50
+ endpoints: (build) => ({
51
+ [searchEndpointKey]: build.query({
52
+ query: (q) => ({
53
+ method: "GET",
54
+ params: { q },
55
+ url: `${routePath}/search`,
56
+ }),
57
+ }),
58
+ [readEndpointKey]: build.query({
59
+ query: (id) => ({
60
+ method: "GET",
61
+ url: `${routePath}/${id}`,
62
+ }),
63
+ }),
64
+ }),
65
+ overrideExisting: true,
66
+ });
67
+ }, [api, routePath, searchEndpointKey, readEndpointKey]);
68
+ const capitalize = (s) => s.charAt(0).toUpperCase() + s.slice(1);
69
+ const useSearchQuery = enhancedApi[`use${capitalize(searchEndpointKey)}Query`];
70
+ const useReadQuery = enhancedApi[`use${capitalize(readEndpointKey)}Query`];
71
+ const { data: searchData, isFetching: isSearching } = useSearchQuery(debouncedQuery, {
72
+ skip: !debouncedQuery,
73
+ });
74
+ // Fetch the currently selected item to display its name
75
+ const { data: selectedItem } = useReadQuery(value, {
76
+ skip: !value,
77
+ });
78
+ // Update display when selected item loads
79
+ useEffect(() => {
80
+ if (selectedItem && value) {
81
+ setSelectedDisplay(getDisplayValue(selectedItem));
82
+ }
83
+ }, [selectedItem, value]);
84
+ const handleSearchChange = useCallback((text) => {
85
+ setSearchText(text);
86
+ setIsOpen(true);
87
+ if (debounceRef.current) {
88
+ clearTimeout(debounceRef.current);
89
+ }
90
+ debounceRef.current = setTimeout(() => {
91
+ setDebouncedQuery(text);
92
+ }, 300);
93
+ }, []);
94
+ const handleSelect = useCallback((item) => {
95
+ onChange(item._id);
96
+ setSelectedDisplay(getDisplayValue(item));
97
+ setSearchText("");
98
+ setDebouncedQuery("");
99
+ setIsOpen(false);
100
+ setIsChanging(false);
101
+ }, [onChange]);
102
+ const handleClear = useCallback(() => {
103
+ onChange("");
104
+ setSelectedDisplay("");
105
+ setSearchText("");
106
+ setDebouncedQuery("");
107
+ setIsOpen(false);
108
+ setIsChanging(false);
109
+ }, [onChange]);
110
+ const handleChange = useCallback(() => {
111
+ setSearchText("");
112
+ setDebouncedQuery("");
113
+ setIsChanging(true);
114
+ setIsOpen(true);
115
+ }, []);
116
+ // emptyApi unwraps `{data: T}` unless the body has `more` (paginated list). Search returns only
117
+ // `{data: [...]}`, so `searchData` is already the result array.
118
+ const results = Array.isArray(searchData)
119
+ ? searchData
120
+ : ((_a = searchData === null || searchData === void 0 ? void 0 : searchData.data) !== null && _a !== void 0 ? _a : []);
121
+ return (_jsxs(Box, { gap: 1, children: [value && selectedDisplay && !isChanging ? (_jsxs(Box, { alignItems: "center", direction: "row", gap: 2, children: [_jsx(Box, { flex: "grow", children: _jsx(TextField, { disabled: true, helperText: helperText, onChange: () => { }, testID: `admin-picker-${refModelName}-display`, title: title, value: selectedDisplay }) }), _jsx(IconButton, { accessibilityHint: "Opens search to pick a different value", accessibilityLabel: "Change selection", iconName: "pencil", onClick: handleChange, testID: `admin-picker-${refModelName}-change` }), _jsx(IconButton, { accessibilityHint: "Clears the current selection", accessibilityLabel: "Clear selection", iconName: "xmark", onClick: handleClear, testID: `admin-picker-${refModelName}-clear` })] })) : (_jsx(TextField, { errorText: errorText, helperText: isOpen ? "Type to search" : helperText, onChange: handleSearchChange, onFocus: () => setIsOpen(true), testID: `admin-picker-${refModelName}-search`, title: title, value: searchText })), isOpen && (_jsxs(Box, { border: "default", maxHeight: 250, overflow: "scrollY", rounding: "md", children: [isSearching && (_jsx(Box, { alignItems: "center", padding: 3, children: _jsx(Spinner, {}) })), !isSearching && debouncedQuery && results.length === 0 && (_jsx(Box, { padding: 3, children: _jsx(Text, { color: "secondaryDark", size: "sm", children: "No results found" }) })), !isSearching &&
122
+ results.map((item) => {
123
+ const primaryField = getPrimaryField(item);
124
+ const secondary = getSecondaryText(item, primaryField);
125
+ return (_jsxs(Box, { accessibilityHint: `Selects ${getDisplayValue(item)}`, accessibilityLabel: `Select ${getDisplayValue(item)}`, onClick: () => handleSelect(item), paddingX: 3, paddingY: 2, testID: `admin-picker-${refModelName}-result-${item._id}`, children: [_jsx(Text, { size: "sm", children: getDisplayValue(item) }), secondary && (_jsx(Text, { color: "secondaryDark", size: "sm", children: secondary }))] }, item._id));
126
+ }), !isSearching && !debouncedQuery && (_jsx(Box, { padding: 3, children: _jsx(Text, { color: "secondaryDark", size: "sm", children: "Start typing to search" }) }))] }))] }));
127
+ };
128
+ //# sourceMappingURL=AdminObjectPicker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AdminObjectPicker.js","sourceRoot":"","sources":["../src/AdminObjectPicker.tsx"],"names":[],"mappings":"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"}
@@ -11,40 +11,5 @@ interface AdminRefFieldProps {
11
11
  errorText?: string;
12
12
  helperText?: string;
13
13
  }
14
- /**
15
- * Select field for choosing a referenced model instance by ID.
16
- *
17
- * Fetches all items from the referenced model and displays them in a dropdown.
18
- * Automatically determines a display label by checking common fields (name, title, email, etc.).
19
- * Falls back to the item's _id if no suitable display field is found.
20
- *
21
- * @param props - Component props
22
- * @param props.api - RTK Query API instance for fetching reference data
23
- * @param props.baseUrl - Base URL for admin routes (not currently used, kept for consistency)
24
- * @param props.routePath - Full route path to the referenced model's list endpoint
25
- * @param props.refModelName - Name of the referenced model (e.g., "User")
26
- * @param props.title - Label displayed above the select field
27
- * @param props.value - Currently selected ID
28
- * @param props.onChange - Callback when selection changes
29
- * @param props.errorText - Optional validation error message
30
- * @param props.helperText - Optional helper text shown below the field
31
- *
32
- * @example
33
- * ```typescript
34
- * <AdminRefField
35
- * api={api}
36
- * baseUrl="/admin"
37
- * routePath="/admin/users"
38
- * refModelName="User"
39
- * title="Owner"
40
- * value={ownerId}
41
- * onChange={(id) => setOwnerId(id)}
42
- * helperText="Select the user who owns this item"
43
- * />
44
- * ```
45
- *
46
- * @see AdminFieldRenderer for field type selection
47
- * @see useAdminApi for the API hook pattern
48
- */
49
14
  export declare const AdminRefField: React.FC<AdminRefFieldProps>;
50
15
  export {};
@@ -1,79 +1,6 @@
1
1
  import { jsx as _jsx } from "react/jsx-runtime";
2
- import { SelectField } from "@terreno/ui";
3
- import { useMemo } from "react";
4
- // Heuristic to find a display field from an item
5
- const getDisplayValue = (item) => {
6
- var _a;
7
- for (const field of ["name", "title", "email", "label", "displayName"]) {
8
- if (item[field]) {
9
- return String(item[field]);
10
- }
11
- }
12
- return (_a = item._id) !== null && _a !== void 0 ? _a : String(item);
13
- };
14
- /**
15
- * Select field for choosing a referenced model instance by ID.
16
- *
17
- * Fetches all items from the referenced model and displays them in a dropdown.
18
- * Automatically determines a display label by checking common fields (name, title, email, etc.).
19
- * Falls back to the item's _id if no suitable display field is found.
20
- *
21
- * @param props - Component props
22
- * @param props.api - RTK Query API instance for fetching reference data
23
- * @param props.baseUrl - Base URL for admin routes (not currently used, kept for consistency)
24
- * @param props.routePath - Full route path to the referenced model's list endpoint
25
- * @param props.refModelName - Name of the referenced model (e.g., "User")
26
- * @param props.title - Label displayed above the select field
27
- * @param props.value - Currently selected ID
28
- * @param props.onChange - Callback when selection changes
29
- * @param props.errorText - Optional validation error message
30
- * @param props.helperText - Optional helper text shown below the field
31
- *
32
- * @example
33
- * ```typescript
34
- * <AdminRefField
35
- * api={api}
36
- * baseUrl="/admin"
37
- * routePath="/admin/users"
38
- * refModelName="User"
39
- * title="Owner"
40
- * value={ownerId}
41
- * onChange={(id) => setOwnerId(id)}
42
- * helperText="Select the user who owns this item"
43
- * />
44
- * ```
45
- *
46
- * @see AdminFieldRenderer for field type selection
47
- * @see useAdminApi for the API hook pattern
48
- */
2
+ import { AdminObjectPicker } from "./AdminObjectPicker";
49
3
  export const AdminRefField = ({ api, routePath, refModelName, title, value, onChange, errorText, helperText, }) => {
50
- const endpointKey = `adminRefList_${refModelName}`;
51
- const enhancedApi = useMemo(() => {
52
- return api.injectEndpoints({
53
- endpoints: (build) => ({
54
- [endpointKey]: build.query({
55
- query: () => ({
56
- method: "GET",
57
- params: { limit: 100 },
58
- url: routePath,
59
- }),
60
- }),
61
- }),
62
- overrideExisting: true,
63
- });
64
- }, [api, routePath, endpointKey]);
65
- const capitalize = (s) => s.charAt(0).toUpperCase() + s.slice(1);
66
- const useRefQuery = enhancedApi[`use${capitalize(endpointKey)}Query`];
67
- const { data, isLoading } = useRefQuery();
68
- const options = useMemo(() => {
69
- if (!(data === null || data === void 0 ? void 0 : data.data)) {
70
- return [];
71
- }
72
- return data.data.map((item) => ({
73
- label: getDisplayValue(item),
74
- value: item._id,
75
- }));
76
- }, [data]);
77
- return (_jsx(SelectField, { disabled: isLoading, errorText: errorText, helperText: helperText, onChange: onChange, options: options, title: title, value: value }));
4
+ return (_jsx(AdminObjectPicker, { api: api, errorText: errorText, helperText: helperText, onChange: onChange, refModelName: refModelName, routePath: routePath, title: title, value: value }));
78
5
  };
79
6
  //# sourceMappingURL=AdminRefField.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"AdminRefField.js","sourceRoot":"","sources":["../src/AdminRefField.tsx"],"names":[],"mappings":";AACA,OAAO,EAAC,WAAW,EAAC,MAAM,aAAa,CAAC;AACxC,OAAc,EAAC,OAAO,EAAC,MAAM,OAAO,CAAC;AAcrC,iDAAiD;AACjD,MAAM,eAAe,GAAG,CAAC,IAAS,EAAU,EAAE;;IAC5C,KAAK,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,CAAC;QACvE,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,MAAA,IAAI,CAAC,GAAG,mCAAI,MAAM,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,MAAM,aAAa,GAAiC,CAAC,EAC1D,GAAG,EACH,SAAS,EACT,YAAY,EACZ,KAAK,EACL,KAAK,EACL,QAAQ,EACR,SAAS,EACT,UAAU,GACX,EAAE,EAAE;IACH,MAAM,WAAW,GAAG,gBAAgB,YAAY,EAAE,CAAC;IAEnD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE;QAC/B,OAAO,GAAG,CAAC,eAAe,CAAC;YACzB,SAAS,EAAE,CAAC,KAAU,EAAE,EAAE,CAAC,CAAC;gBAC1B,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;oBACzB,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;wBACZ,MAAM,EAAE,KAAK;wBACb,MAAM,EAAE,EAAC,KAAK,EAAE,GAAG,EAAC;wBACpB,GAAG,EAAE,SAAS;qBACf,CAAC;iBACH,CAAC;aACH,CAAC;YACF,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;IAElC,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,WAAW,GAAI,WAAmB,CAAC,MAAM,UAAU,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC/E,MAAM,EAAC,IAAI,EAAE,SAAS,EAAC,GAAG,WAAW,EAAE,CAAC;IAExC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3B,IAAI,CAAC,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,IAAI,CAAA,EAAE,CAAC;YAChB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,CAAC;YACnC,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC;YAC5B,KAAK,EAAE,IAAI,CAAC,GAAG;SAChB,CAAC,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,OAAO,CACL,KAAC,WAAW,IACV,QAAQ,EAAE,SAAS,EACnB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,GACZ,CACH,CAAC;AACJ,CAAC,CAAC"}
1
+ {"version":3,"file":"AdminRefField.js","sourceRoot":"","sources":["../src/AdminRefField.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AActD,MAAM,CAAC,MAAM,aAAa,GAAiC,CAAC,EAC1D,GAAG,EACH,SAAS,EACT,YAAY,EACZ,KAAK,EACL,KAAK,EACL,QAAQ,EACR,SAAS,EACT,UAAU,GACX,EAAE,EAAE;IACH,OAAO,CACL,KAAC,iBAAiB,IAChB,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,GACZ,CACH,CAAC;AACJ,CAAC,CAAC"}
package/dist/index.d.ts CHANGED
@@ -3,6 +3,7 @@ export { AdminModelForm } from "./AdminModelForm";
3
3
  export { AdminModelList } from "./AdminModelList";
4
4
  export { AdminModelTable } from "./AdminModelTable";
5
5
  export { AdminNestedArrayField } from "./AdminNestedArrayField";
6
+ export { AdminObjectPicker } from "./AdminObjectPicker";
6
7
  export { AdminRefField } from "./AdminRefField";
7
8
  export { AdminScriptList } from "./AdminScriptList";
8
9
  export { AdminScriptRunModal } from "./AdminScriptRunModal";
package/dist/index.js CHANGED
@@ -3,6 +3,7 @@ export { AdminModelForm } from "./AdminModelForm";
3
3
  export { AdminModelList } from "./AdminModelList";
4
4
  export { AdminModelTable } from "./AdminModelTable";
5
5
  export { AdminNestedArrayField } from "./AdminNestedArrayField";
6
+ export { AdminObjectPicker } from "./AdminObjectPicker";
6
7
  export { AdminRefField } from "./AdminRefField";
7
8
  export { AdminScriptList } from "./AdminScriptList";
8
9
  export { AdminScriptRunModal } from "./AdminScriptRunModal";
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAC,sBAAsB,EAAC,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAC;AAa1D,OAAO,EAAC,aAAa,EAAC,MAAM,SAAS,CAAC;AACtC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAC,sBAAsB,EAAC,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAC;AAa1D,OAAO,EAAC,aAAa,EAAC,MAAM,SAAS,CAAC;AACtC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAC"}
package/dist/types.d.ts CHANGED
@@ -6,6 +6,7 @@ export interface AdminFieldConfig {
6
6
  enum?: string[];
7
7
  default?: any;
8
8
  ref?: string;
9
+ searchable?: boolean;
9
10
  widget?: string;
10
11
  /** For array fields: metadata about each item's sub-fields */
11
12
  items?: Record<string, AdminFieldConfig>;
package/dist/types.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAyEA,gDAAgD;AAChD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA0EA,gDAAgD;AAChD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "dependencies": {
3
- "@terreno/ui": "0.9.3",
3
+ "@terreno/ui": "0.10.0",
4
4
  "expo-router": "~6.0.19",
5
5
  "jspdf": "^4.2.0",
6
6
  "lodash": "^4.17.23",
@@ -50,5 +50,5 @@
50
50
  "test:ci": "bun test"
51
51
  },
52
52
  "types": "dist/index.d.ts",
53
- "version": "0.9.3"
53
+ "version": "0.10.0"
54
54
  }
@@ -0,0 +1,255 @@
1
+ import type {Api} from "@reduxjs/toolkit/query/react";
2
+ import {Box, IconButton, Spinner, Text, TextField} from "@terreno/ui";
3
+ import React, {useCallback, useEffect, useMemo, useRef, useState} from "react";
4
+
5
+ interface AdminObjectPickerProps {
6
+ api: Api<any, any, any, any>;
7
+ routePath: string;
8
+ refModelName: string;
9
+ title: string;
10
+ value: string;
11
+ onChange: (value: string) => void;
12
+ errorText?: string;
13
+ helperText?: string;
14
+ }
15
+
16
+ const DISPLAY_FIELDS = ["name", "title", "email", "label", "displayName"];
17
+
18
+ const getDisplayValue = (item: any): string => {
19
+ for (const field of DISPLAY_FIELDS) {
20
+ if (item[field]) {
21
+ return String(item[field]);
22
+ }
23
+ }
24
+ return item._id ?? String(item);
25
+ };
26
+
27
+ const getSecondaryText = (item: any, primaryField: string): string | undefined => {
28
+ for (const field of DISPLAY_FIELDS) {
29
+ if (field !== primaryField && item[field]) {
30
+ return String(item[field]);
31
+ }
32
+ }
33
+ return undefined;
34
+ };
35
+
36
+ const getPrimaryField = (item: any): string => {
37
+ for (const field of DISPLAY_FIELDS) {
38
+ if (item[field]) {
39
+ return field;
40
+ }
41
+ }
42
+ return "_id";
43
+ };
44
+
45
+ export const AdminObjectPicker: React.FC<AdminObjectPickerProps> = ({
46
+ api,
47
+ routePath,
48
+ refModelName,
49
+ title,
50
+ value,
51
+ onChange,
52
+ errorText,
53
+ helperText,
54
+ }) => {
55
+ const [searchText, setSearchText] = useState("");
56
+ const [isOpen, setIsOpen] = useState(false);
57
+ const [isChanging, setIsChanging] = useState(false);
58
+ const [selectedDisplay, setSelectedDisplay] = useState("");
59
+ const debounceRef = useRef<ReturnType<typeof setTimeout> | null>(null);
60
+ const [debouncedQuery, setDebouncedQuery] = useState("");
61
+
62
+ // Clear pending debounce on unmount
63
+ useEffect(() => {
64
+ return () => {
65
+ if (debounceRef.current) {
66
+ clearTimeout(debounceRef.current);
67
+ }
68
+ };
69
+ }, []);
70
+
71
+ const searchEndpointKey = `adminSearch_${refModelName}`;
72
+ const readEndpointKey = `adminSearchRead_${refModelName}`;
73
+
74
+ const enhancedApi = useMemo(() => {
75
+ return api.injectEndpoints({
76
+ endpoints: (build: any) => ({
77
+ [searchEndpointKey]: build.query({
78
+ query: (q: string) => ({
79
+ method: "GET",
80
+ params: {q},
81
+ url: `${routePath}/search`,
82
+ }),
83
+ }),
84
+ [readEndpointKey]: build.query({
85
+ query: (id: string) => ({
86
+ method: "GET",
87
+ url: `${routePath}/${id}`,
88
+ }),
89
+ }),
90
+ }),
91
+ overrideExisting: true,
92
+ });
93
+ }, [api, routePath, searchEndpointKey, readEndpointKey]);
94
+
95
+ const capitalize = (s: string) => s.charAt(0).toUpperCase() + s.slice(1);
96
+ const useSearchQuery = (enhancedApi as any)[`use${capitalize(searchEndpointKey)}Query`];
97
+ const useReadQuery = (enhancedApi as any)[`use${capitalize(readEndpointKey)}Query`];
98
+
99
+ const {data: searchData, isFetching: isSearching} = useSearchQuery(debouncedQuery, {
100
+ skip: !debouncedQuery,
101
+ });
102
+
103
+ // Fetch the currently selected item to display its name
104
+ const {data: selectedItem} = useReadQuery(value, {
105
+ skip: !value,
106
+ });
107
+
108
+ // Update display when selected item loads
109
+ useEffect(() => {
110
+ if (selectedItem && value) {
111
+ setSelectedDisplay(getDisplayValue(selectedItem));
112
+ }
113
+ }, [selectedItem, value]);
114
+
115
+ const handleSearchChange = useCallback((text: string) => {
116
+ setSearchText(text);
117
+ setIsOpen(true);
118
+
119
+ if (debounceRef.current) {
120
+ clearTimeout(debounceRef.current);
121
+ }
122
+ debounceRef.current = setTimeout(() => {
123
+ setDebouncedQuery(text);
124
+ }, 300);
125
+ }, []);
126
+
127
+ const handleSelect = useCallback(
128
+ (item: any) => {
129
+ onChange(item._id);
130
+ setSelectedDisplay(getDisplayValue(item));
131
+ setSearchText("");
132
+ setDebouncedQuery("");
133
+ setIsOpen(false);
134
+ setIsChanging(false);
135
+ },
136
+ [onChange]
137
+ );
138
+
139
+ const handleClear = useCallback(() => {
140
+ onChange("");
141
+ setSelectedDisplay("");
142
+ setSearchText("");
143
+ setDebouncedQuery("");
144
+ setIsOpen(false);
145
+ setIsChanging(false);
146
+ }, [onChange]);
147
+
148
+ const handleChange = useCallback(() => {
149
+ setSearchText("");
150
+ setDebouncedQuery("");
151
+ setIsChanging(true);
152
+ setIsOpen(true);
153
+ }, []);
154
+
155
+ // emptyApi unwraps `{data: T}` unless the body has `more` (paginated list). Search returns only
156
+ // `{data: [...]}`, so `searchData` is already the result array.
157
+ const results = Array.isArray(searchData)
158
+ ? searchData
159
+ : ((searchData as {data?: unknown[]} | undefined)?.data ?? []);
160
+
161
+ return (
162
+ <Box gap={1}>
163
+ {value && selectedDisplay && !isChanging ? (
164
+ <Box alignItems="center" direction="row" gap={2}>
165
+ <Box flex="grow">
166
+ <TextField
167
+ disabled
168
+ helperText={helperText}
169
+ onChange={() => {}}
170
+ testID={`admin-picker-${refModelName}-display`}
171
+ title={title}
172
+ value={selectedDisplay}
173
+ />
174
+ </Box>
175
+ <IconButton
176
+ accessibilityHint="Opens search to pick a different value"
177
+ accessibilityLabel="Change selection"
178
+ iconName="pencil"
179
+ onClick={handleChange}
180
+
181
+ testID={`admin-picker-${refModelName}-change`}
182
+ />
183
+ <IconButton
184
+ accessibilityHint="Clears the current selection"
185
+ accessibilityLabel="Clear selection"
186
+ iconName="xmark"
187
+ onClick={handleClear}
188
+
189
+ testID={`admin-picker-${refModelName}-clear`}
190
+ />
191
+ </Box>
192
+ ) : (
193
+ <TextField
194
+ errorText={errorText}
195
+ helperText={isOpen ? "Type to search" : helperText}
196
+ onChange={handleSearchChange}
197
+ onFocus={() => setIsOpen(true)}
198
+ testID={`admin-picker-${refModelName}-search`}
199
+ title={title}
200
+ value={searchText}
201
+ />
202
+ )}
203
+
204
+ {isOpen && (
205
+ <Box border="default" maxHeight={250} overflow="scrollY" rounding="md">
206
+ {isSearching && (
207
+ <Box alignItems="center" padding={3}>
208
+ <Spinner />
209
+ </Box>
210
+ )}
211
+
212
+ {!isSearching && debouncedQuery && results.length === 0 && (
213
+ <Box padding={3}>
214
+ <Text color="secondaryDark" size="sm">
215
+ No results found
216
+ </Text>
217
+ </Box>
218
+ )}
219
+
220
+ {!isSearching &&
221
+ results.map((item: any) => {
222
+ const primaryField = getPrimaryField(item);
223
+ const secondary = getSecondaryText(item, primaryField);
224
+ return (
225
+ <Box
226
+ accessibilityHint={`Selects ${getDisplayValue(item)}`}
227
+ accessibilityLabel={`Select ${getDisplayValue(item)}`}
228
+ key={item._id}
229
+ onClick={() => handleSelect(item)}
230
+ paddingX={3}
231
+ paddingY={2}
232
+ testID={`admin-picker-${refModelName}-result-${item._id}`}
233
+ >
234
+ <Text size="sm">{getDisplayValue(item)}</Text>
235
+ {secondary && (
236
+ <Text color="secondaryDark" size="sm">
237
+ {secondary}
238
+ </Text>
239
+ )}
240
+ </Box>
241
+ );
242
+ })}
243
+
244
+ {!isSearching && !debouncedQuery && (
245
+ <Box padding={3}>
246
+ <Text color="secondaryDark" size="sm">
247
+ Start typing to search
248
+ </Text>
249
+ </Box>
250
+ )}
251
+ </Box>
252
+ )}
253
+ </Box>
254
+ );
255
+ };
@@ -1,6 +1,6 @@
1
1
  import type {Api} from "@reduxjs/toolkit/query/react";
2
- import {SelectField} from "@terreno/ui";
3
- import React, {useMemo} from "react";
2
+ import React from "react";
3
+ import {AdminObjectPicker} from "./AdminObjectPicker";
4
4
 
5
5
  interface AdminRefFieldProps {
6
6
  api: Api<any, any, any, any>;
@@ -14,51 +14,6 @@ interface AdminRefFieldProps {
14
14
  helperText?: string;
15
15
  }
16
16
 
17
- // Heuristic to find a display field from an item
18
- const getDisplayValue = (item: any): string => {
19
- for (const field of ["name", "title", "email", "label", "displayName"]) {
20
- if (item[field]) {
21
- return String(item[field]);
22
- }
23
- }
24
- return item._id ?? String(item);
25
- };
26
-
27
- /**
28
- * Select field for choosing a referenced model instance by ID.
29
- *
30
- * Fetches all items from the referenced model and displays them in a dropdown.
31
- * Automatically determines a display label by checking common fields (name, title, email, etc.).
32
- * Falls back to the item's _id if no suitable display field is found.
33
- *
34
- * @param props - Component props
35
- * @param props.api - RTK Query API instance for fetching reference data
36
- * @param props.baseUrl - Base URL for admin routes (not currently used, kept for consistency)
37
- * @param props.routePath - Full route path to the referenced model's list endpoint
38
- * @param props.refModelName - Name of the referenced model (e.g., "User")
39
- * @param props.title - Label displayed above the select field
40
- * @param props.value - Currently selected ID
41
- * @param props.onChange - Callback when selection changes
42
- * @param props.errorText - Optional validation error message
43
- * @param props.helperText - Optional helper text shown below the field
44
- *
45
- * @example
46
- * ```typescript
47
- * <AdminRefField
48
- * api={api}
49
- * baseUrl="/admin"
50
- * routePath="/admin/users"
51
- * refModelName="User"
52
- * title="Owner"
53
- * value={ownerId}
54
- * onChange={(id) => setOwnerId(id)}
55
- * helperText="Select the user who owns this item"
56
- * />
57
- * ```
58
- *
59
- * @see AdminFieldRenderer for field type selection
60
- * @see useAdminApi for the API hook pattern
61
- */
62
17
  export const AdminRefField: React.FC<AdminRefFieldProps> = ({
63
18
  api,
64
19
  routePath,
@@ -69,44 +24,14 @@ export const AdminRefField: React.FC<AdminRefFieldProps> = ({
69
24
  errorText,
70
25
  helperText,
71
26
  }) => {
72
- const endpointKey = `adminRefList_${refModelName}`;
73
-
74
- const enhancedApi = useMemo(() => {
75
- return api.injectEndpoints({
76
- endpoints: (build: any) => ({
77
- [endpointKey]: build.query({
78
- query: () => ({
79
- method: "GET",
80
- params: {limit: 100},
81
- url: routePath,
82
- }),
83
- }),
84
- }),
85
- overrideExisting: true,
86
- });
87
- }, [api, routePath, endpointKey]);
88
-
89
- const capitalize = (s: string) => s.charAt(0).toUpperCase() + s.slice(1);
90
- const useRefQuery = (enhancedApi as any)[`use${capitalize(endpointKey)}Query`];
91
- const {data, isLoading} = useRefQuery();
92
-
93
- const options = useMemo(() => {
94
- if (!data?.data) {
95
- return [];
96
- }
97
- return data.data.map((item: any) => ({
98
- label: getDisplayValue(item),
99
- value: item._id,
100
- }));
101
- }, [data]);
102
-
103
27
  return (
104
- <SelectField
105
- disabled={isLoading}
28
+ <AdminObjectPicker
29
+ api={api}
106
30
  errorText={errorText}
107
31
  helperText={helperText}
108
32
  onChange={onChange}
109
- options={options}
33
+ refModelName={refModelName}
34
+ routePath={routePath}
110
35
  title={title}
111
36
  value={value}
112
37
  />
package/src/index.tsx CHANGED
@@ -3,6 +3,7 @@ export {AdminModelForm} from "./AdminModelForm";
3
3
  export {AdminModelList} from "./AdminModelList";
4
4
  export {AdminModelTable} from "./AdminModelTable";
5
5
  export {AdminNestedArrayField} from "./AdminNestedArrayField";
6
+ export {AdminObjectPicker} from "./AdminObjectPicker";
6
7
  export {AdminRefField} from "./AdminRefField";
7
8
  export {AdminScriptList} from "./AdminScriptList";
8
9
  export {AdminScriptRunModal} from "./AdminScriptRunModal";
package/src/types.ts CHANGED
@@ -7,6 +7,7 @@ export interface AdminFieldConfig {
7
7
  enum?: string[];
8
8
  default?: any;
9
9
  ref?: string;
10
+ searchable?: boolean;
10
11
  widget?: string;
11
12
  /** For array fields: metadata about each item's sub-fields */
12
13
  items?: Record<string, AdminFieldConfig>;