# Summary Refactor the React OpenAPI admin framework to support fully customizable field rendering and UI composition. ## Changes ### Admin UI Customization * Added support for custom: * Dashboard component * Layout component * Login page component * Introduced `AdminAppProps` and extended `Admin` configuration API. * Renamed internal dashboard implementation to `DefaultDashboard`. ### Field Component Architecture * Extracted field rendering into dedicated field components: * TextField * NumberField * BooleanField * DateField * EnumField * RelationField * ObjectField * FallbackField * DateRangeField * NumberRangeField * Added `defaultFieldComponents` registry. * Refactored `FormField` to resolve components dynamically from a component map instead of hardcoded field type handling. ### Resource Customization * Added `FieldComponents` support across: * Admin * ResourceView * GenericForm * useResource * Introduced wrapped `FormField` and `GenericForm` components generated from configured field overrides. ### Table Customization * Added `EnhancedTableComponents`. * Added support for custom cell renderers per field type. * Enabled custom rendering for both desktop and mobile table layouts. ### Filter Improvements * Exported `FilterAutocomplete`. * Added support for custom date-range and number-range filter components. * Added filter component extension points. * Updated filter option label resolution to support `displayFormat`. ### Display Formatting * Replaced `displayField` usage with `displayFormat`. * Added template-based display rendering support through `resolveTemplate`. * Improved relation display configuration handling. ### TypeScript Improvements * Added TypeScript as a project dependency. * Removed multiple `@ts-ignore` usages. * Added strongly typed Axios wrapper methods with generic response support. * Improved typing across hooks and component interfaces. ### OpenAPI Configuration Validation * Added validation for enum fields without enum values. * Added validation for relation resources missing `referenceOptions.enumOption`. * Improved relation metadata propagation during schema parsing. ### Library Exports * Exported: * Field component types * Override types * EnhancedTable * GenericForm * ResourceView * Field components and defaults * Expanded public API surface for consumers extending the framework. ## Benefits * Enables complete UI customization without modifying framework internals. * Simplifies creation of custom field types and renderers. * Improves type safety and developer experience. * Provides consistent extension points for forms, tables, filters, and admin layouts. * Makes the framework more suitable for reusable library distribution. Reviewed-on: #11 Co-authored-by: Vishesh 'ironeagle' Bangotra <aetoskia@gmail.com> Co-committed-by: Vishesh 'ironeagle' Bangotra <aetoskia@gmail.com>
51 lines
1.7 KiB
TypeScript
51 lines
1.7 KiB
TypeScript
import { FormControl, InputLabel, Select, MenuItem } from '@mui/material';
|
|
import { getFieldOptions } from '../../utils/options';
|
|
import { FieldComponentProps } from '../../types/overrides';
|
|
|
|
export default function RelationField({ field, value, onChange, disabled, relationDataMap = {} }: FieldComponentProps) {
|
|
if (!field.relation || !relationDataMap[field.relation]) {
|
|
return null;
|
|
}
|
|
|
|
const relationData = relationDataMap[field.relation];
|
|
const isArrayRelation = field.type === 'array';
|
|
const options = getFieldOptions(field, relationData);
|
|
const keyField = field.enumOption?.key ?? 'id';
|
|
|
|
const normalizedValue = (() => {
|
|
if (isArrayRelation && Array.isArray(value)) {
|
|
return value.map((v: any) => (v != null && typeof v === 'object' ? String(v[keyField] ?? '') : String(v)));
|
|
}
|
|
if (value != null && typeof value === 'object') {
|
|
return String(value[keyField] ?? '');
|
|
}
|
|
return value ?? (isArrayRelation ? [] : "");
|
|
})();
|
|
|
|
return (
|
|
<FormControl fullWidth>
|
|
<InputLabel shrink>{field.label}</InputLabel>
|
|
<Select
|
|
multiple={isArrayRelation}
|
|
value={normalizedValue}
|
|
label={field.label}
|
|
displayEmpty
|
|
onChange={(e) => onChange(e.target.value)}
|
|
disabled={disabled}
|
|
renderValue={(selected: any) => {
|
|
if (isArrayRelation) {
|
|
return (selected as string[]).map(k => options.find(o => o.key === k)?.value ?? k).join(', ');
|
|
}
|
|
return options.find(o => o.key === selected)?.value ?? selected;
|
|
}}
|
|
>
|
|
{options.map((opt) => (
|
|
<MenuItem key={opt.key} value={opt.key}>
|
|
{opt.value}
|
|
</MenuItem>
|
|
))}
|
|
</Select>
|
|
</FormControl>
|
|
);
|
|
}
|