useDocyrusFieldComponent

Installation

pnpm dlx @docyrus/cli add @docyrus/rn-hooks-use-docyrus-field-component

Depends on @docyrus/rn-form-fields, @docyrus/rn-value-renderers and @docyrus/rn-editable-value (installed with it).

Overview

Native port of the web useDocyrusFieldComponent. The registries map every IFieldType to native components:

• form-field — the IField adapter DocyFieldDynamic, typed as ComponentType<DocyrusFormFieldProps> (field, value, onChange, record, onCompanionChange, …). null for types without a native editor mapping (computed / system types).
• value-renderer — the DocyValue* renderer; unknown types fall back to DocyValueText.
• editable-value — always EditableValue, which dispatches by field type.

The web-only kinds data-grid-cell-variant and tanstack-column-def live with the native data-grid package.

Usage

import { useDocyrusFieldComponent } from '@/hooks/docyrus-native/use-docyrus-field-component';

function FieldRow({ field, record, onChange }) {
  const Form = useDocyrusFieldComponent(field.type, 'form-field');
  const Value = useDocyrusFieldComponent(field.type, 'value-renderer');

  if (!Form) return <Value field={field} value={record[field.slug]} record={record} />;

  return (
    <Form
      field={field}
      value={record[field.slug]}
      record={record}
      onChange={value => onChange(field.slug, value)}
      onCompanionChange={onChange} />
  );
}

import { extractEnumOptions, toIField } from '@/hooks/docyrus-native/use-docyrus-field-component';

// DataSourceField (app-utils) → IField + inline options
const field = toIField(dataSourceField);
const options = extractEnumOptions(dataSourceField);

API Reference

useDocyrusFieldComponent(fieldType, kind)

Returns DocyrusFieldComponentResult<K> — ComponentType<DocyrusFormFieldProps> \| null, ComponentType<DocyValueProps> or typeof EditableValue.

Exports

Types