import { useArrayMapMemo, useConstantLengthInvariant } from '@contember/react-utils' import { ReactElement, ReactNode, useCallback, useMemo } from 'react' import { useEntity } from '../accessorPropagation' import type { FieldAccessor, FieldValue, RelativeSingleField, SugaredRelativeSingleField } from '@contember/binding' import { QueryLanguage, throwBindingError } from '@contember/binding' import { Component } from '../coreComponents' import { SugaredField } from './SugaredField' export interface FieldViewCommonProps { fallbackIfUnpersisted?: ReactNode } export type FieldViewProps = & FieldViewCommonProps & ( | { render: (...accessors: FieldAccessor[]) => ReactNode field: string | SugaredRelativeSingleField } | { render: (...accessors: FieldAccessor[]) => ReactNode fields: Array } ) /** * Base field view component with no default formatting. * * @example * ``` * <>{accessor.value}} * /> * ``` * * @group Field Views */ export const FieldView = Component( props => { const { fallbackIfUnpersisted, render } = props const fields = 'fields' in props && Array.isArray(props.fields) ? props.fields : 'field' in props && props.field ? [props.field] : throwBindingError(`FieldView: failed to supply either the 'field' or the 'fields' prop.`) useConstantLengthInvariant( fields, `The number of fields in the 'fields' prop of the 'FieldView' must remain constant between renders!`, ) // TODO over-subscribe less const entityAccessor = useEntity() const environment = entityAccessor.environment const desugarField = useCallback( (rsf: string | SugaredRelativeSingleField) => QueryLanguage.desugarRelativeSingleField(rsf, environment), [environment], ) const desugaredFields = useArrayMapMemo(fields, desugarField) const retrieveField = useCallback( (desugaredRsf: RelativeSingleField) => entityAccessor.getField(desugaredRsf), [entityAccessor], ) const accessors = useArrayMapMemo(desugaredFields, retrieveField) // TODO we probably want something like useDeferredValue from here. // Will probably just wait for Concurrent React though. const output = useMemo(() => { if (!entityAccessor.existsOnServer && fallbackIfUnpersisted !== undefined) { return fallbackIfUnpersisted } return render(...accessors) }, [accessors, entityAccessor.existsOnServer, fallbackIfUnpersisted, render]) return <>{output} }, props => { const fields = 'fields' in props && Array.isArray(props.fields) ? props.fields : 'field' in props && props.field ? [props.field] : throwBindingError(`FieldView: failed to supply either the 'field' or the 'fields' prop.`) return ( <> {props.fallbackIfUnpersisted} {fields.map((field, i) => ( ))} ) }, 'FieldView', ) as FieldViewComponentSignature export type FieldViewComponentSignature = { ( props: & FieldViewCommonProps & { field: string | SugaredRelativeSingleField render: (field1: FieldAccessor) => ReactNode }, ): ReactElement | null ( props: & FieldViewCommonProps & { fields: [string | SugaredRelativeSingleField] render: (field1: FieldAccessor) => ReactNode }, ): ReactElement | null ( props: & FieldViewCommonProps & { fields: [string | SugaredRelativeSingleField, string | SugaredRelativeSingleField] render: (field1: FieldAccessor, field2: FieldAccessor) => ReactNode }, ): ReactElement | null ( props: & FieldViewCommonProps & { fields: [string | SugaredRelativeSingleField, string | SugaredRelativeSingleField, string | SugaredRelativeSingleField] render: (field1: FieldAccessor, field2: FieldAccessor, field3: FieldAccessor) => ReactNode }, ): ReactElement | null ( props: & FieldViewCommonProps & { fields: [string | SugaredRelativeSingleField, string | SugaredRelativeSingleField, string | SugaredRelativeSingleField, string | SugaredRelativeSingleField] render: (field1: FieldAccessor, field2: FieldAccessor, field3: FieldAccessor, field4: FieldAccessor) => ReactNode }, ): ReactElement | null ( props: & FieldViewCommonProps & { fields: [string | SugaredRelativeSingleField, string | SugaredRelativeSingleField, string | SugaredRelativeSingleField, string | SugaredRelativeSingleField, string | SugaredRelativeSingleField] render: (field1: FieldAccessor, field2: FieldAccessor, field3: FieldAccessor, field4: FieldAccessor, field5: FieldAccessor) => ReactNode }, ): ReactElement | null (props: FieldViewProps): ReactElement | null }