@dxos/react-ui-form 0.7.4 → 0.7.5-labs.071a3e2

package/src/components/Form/Form.stories.tsx

@@ -36,7 +36,7 @@ type TestType = S.Schema.Type<typeof TestSchema>;
 
 type StoryProps<T extends BaseObject> = { schema: S.Schema<T> } & FormProps<T>;
 
-const DefaultStory = <T extends BaseObject>({ schema, values: initialValues }: StoryProps<T>) => {
+const DefaultStory = <T extends BaseObject>({ schema, values: initialValues, ...props }: StoryProps<T>) => {
   const [values, setValues] = useState(initialValues);
   const handleSave = useCallback<NonNullable<FormProps<T>['onSave']>>((values) => {
     setValues(values);
@@ -45,7 +45,7 @@ const DefaultStory = <T extends BaseObject>({ schema, values: initialValues }: S
   return (
     <TestLayout json={{ values, schema: schema.ast.toJSON() }}>
       <TestPanel>
-        <Form<T> schema={schema} values={values} onSave={handleSave} />
+        <Form<T> schema={schema} values={values} onSave={handleSave} {...props} />
       </TestPanel>
     </TestLayout>
   );
@@ -78,17 +78,27 @@ export const Default: Story<TestType> = {
   },
 };
 
-// TODO(burdon): Should accept partial values.
 export const Org: Story<Testing.OrgSchemaType> = {
   args: {
     schema: Testing.OrgSchema,
     values: {
-      // name: 'DXOS',
+      name: 'DXOS',
       // website: 'https://dxos.org',
     },
   },
 };
 
+export const OrgAutoSave: Story<Testing.OrgSchemaType> = {
+  args: {
+    schema: Testing.OrgSchema,
+    values: {
+      name: 'DXOS',
+      // website: 'https://dxos.org',
+    },
+    autoSave: true,
+  },
+};
+
 // TODO(burdon): Type issue with employer reference.
 // TODO(burdon): Test table/form with compound values (e.g., address).
 // export const Contact: Story<Testing.ContactSchemaType> = {
@@ -114,7 +124,7 @@ const ShapeSchema = S.Struct({
       }),
       S.Struct({
         type: S.Literal('square').annotations({ [AST.TitleAnnotationId]: 'Type' }),
-        size: S.optional(S.Number.annotations({ [AST.TitleAnnotationId]: 'Size' })),
+        size: S.optional(S.Number.pipe(S.nonNegative()).annotations({ [AST.TitleAnnotationId]: 'Size' })),
       }),
     ).annotations({ [AST.TitleAnnotationId]: 'Shape' }),
   ),
@@ -139,7 +149,7 @@ const DiscriminatedUnionStory = ({ values: initialValues }: DiscriminatedUnionSt
           onSave={handleSave}
           Custom={{
             ['shape.type' as const]: (props) => (
-              <SelectInput<ShapeType>
+              <SelectInput
                 {...props}
                 options={['circle', 'square'].map((value) => ({
                   value,
@@ -197,3 +207,35 @@ export const Arrays: StoryObj<FormProps<ArraysType>> = {
     },
   },
 };
+
+const ColorSchema = S.Struct({
+  color: S.Union(S.Literal('red'), S.Literal('green'), S.Literal('blue')).annotations({
+    [AST.TitleAnnotationId]: 'Color',
+  }),
+}).pipe(S.mutable);
+
+type ColorType = S.Schema.Type<typeof ColorSchema>;
+
+const EnumStory = ({ values: initialValues }: FormProps<ColorType>) => {
+  const [values, setValues] = useState(initialValues);
+  const handleSave = useCallback<NonNullable<FormProps<ColorType>['onSave']>>((values) => {
+    setValues(values);
+  }, []);
+
+  return (
+    <TestLayout json={{ values, schema: ColorSchema.ast.toJSON() }}>
+      <TestPanel>
+        <Form<ColorType> schema={ColorSchema} values={values} onSave={handleSave} />
+      </TestPanel>
+    </TestLayout>
+  );
+};
+
+export const Enum: StoryObj<FormProps<ColorType>> = {
+  render: EnumStory,
+  args: {
+    values: {
+      color: 'red',
+    },
+  },
+};

package/src/components/Form/Form.tsx

@@ -2,34 +2,32 @@
 // Copyright 2024 DXOS.org
 //
 
-import { pipe } from 'effect';
-import { capitalize } from 'effect/String';
-import React, { useEffect, useMemo } from 'react';
+import React, { type ReactElement, useEffect, useMemo } from 'react';
 
-import { AST, type BaseObject, S, type PropertyKey, type FormatEnum } from '@dxos/echo-schema';
-import { findNode, getDiscriminatedType, isDiscriminatedUnion, SimpleType } from '@dxos/effect';
-import { log } from '@dxos/log';
-import { IconButton, type ThemedClassName, useTranslation } from '@dxos/react-ui';
+import { type BaseObject, type S, type PropertyKey } from '@dxos/echo-schema';
+import { type ThemedClassName } from '@dxos/react-ui';
 import { mx } from '@dxos/react-ui-theme';
-import { getSchemaProperties, type SchemaProperty } from '@dxos/schema';
-import { isNotFalsy } from '@dxos/util';
+import { type SchemaProperty } from '@dxos/schema';
 
-import { SelectInput } from './Defaults';
-import { InputHeader, type InputComponent } from './Input';
-import { getInputComponent } from './factory';
-import { type FormHandler, type FormOptions, useForm } from '../../hooks';
-import { translationKey } from '../../translations';
+import { FormActions } from './FormActions';
+import { FormFields } from './FormContent';
+import { FormProvider } from './FormContext';
+import { type InputProps, type InputComponent } from './Input';
+import { type FormOptions } from '../../hooks';
 
-// TODO(burdon): Rename package react-ui-form; delete react-ui-card.
+export type PropsFilter<T extends BaseObject> = (props: SchemaProperty<T>[]) => SchemaProperty<T>[];
 
-const padding = 'px-2';
+export type ComponentLookup = (args: {
+  prop: string;
+  schema: S.Schema<any>;
+  inputProps: InputProps;
+}) => ReactElement | undefined;
 
-export type PropsFilter<T extends BaseObject> = (props: SchemaProperty<T>[]) => SchemaProperty<T>[];
+export type CustomInputMap = Partial<Record<string, InputComponent>>;
 
 export type FormProps<T extends BaseObject> = ThemedClassName<
   {
-    // TODO(burdon): Partial<T>?
-    values: T;
+    values: Partial<T>;
 
     /** Path to the current object from the root. Used with nested forms. */
     path?: string[];
@@ -43,23 +41,21 @@ export type FormProps<T extends BaseObject> = ThemedClassName<
     autoSave?: boolean;
     testId?: string;
     onCancel?: () => void;
-
+    lookupComponent?: ComponentLookup;
     /**
      * Map of custom renderers for specific properties.
+     * Prefer lookupComponent for plugin specific input surfaces.
      */
-    Custom?: Partial<Record<string, InputComponent<T>>>;
+    Custom?: CustomInputMap;
   } & Pick<FormOptions<T>, 'schema' | 'onValuesChanged' | 'onValidate' | 'onSave'>
 >;
 
-/**
- * General purpose form component that displays field controls based on the given schema.
- */
-// TODO(burdon): Area to show general validation errors.
 export const Form = <T extends BaseObject>({
   classNames,
   schema,
   values: initialValues,
   path = [],
+  autoFocus,
   readonly,
   filter,
   sort,
@@ -69,319 +65,43 @@ export const Form = <T extends BaseObject>({
   onValidate,
   onSave,
   onCancel,
+  lookupComponent,
   Custom,
 }: FormProps<T>) => {
   const onValid = useMemo(() => (autoSave ? onSave : undefined), [autoSave, onSave]);
-  const { canSave, values, errors, handleSave, ...inputProps } = useForm<T>({
-    schema,
-    initialValues,
-    onValuesChanged,
-    onValidate,
-    onValid,
-    onSave,
-  });
-
-  // Filter and sort props.
-  // TODO(burdon): Move into useForm?
-  const properties = useMemo(() => {
-    const props = getSchemaProperties<T>(schema.ast, values);
-    const filtered = filter ? filter(props) : props;
-    const findIndex = (props: PropertyKey<T>[], prop: PropertyKey<T>) => {
-      const idx = props.findIndex((p) => p === prop);
-      return idx === -1 ? Infinity : idx;
-    };
-
-    return sort ? filtered.sort(({ name: a }, { name: b }) => findIndex(sort, a) - findIndex(sort, b)) : filtered;
-  }, [schema, filter, values]);
 
-  // TODO(burdon): Highlight in UX.
+  // TODO(burdon): Hack to select first input.
   useEffect(() => {
-    if (errors && Object.keys(errors).length) {
-      log.warn('validation', { errors });
+    if (autoFocus) {
+      const input = document.querySelector('input');
+      if (input) {
+        input.focus();
+      }
     }
-  }, [errors]);
+  }, [autoFocus]);
 
   return (
-    <div role='form' className={mx('flex flex-col w-full gap-2 py-2', classNames)} data-testid={testId}>
-      {properties
-        .map((property) => {
-          const { ast, name, type, format, title, description, examples, options, array } = property;
-          const key = [...path, name];
-          const label = title ?? pipe(name, capitalize);
-          const placeholder = examples?.length ? `Example: "${examples[0]}"` : description;
-
-          // Get generic input.
-          // TODO(ZaymonFC): We might need to switch this to using globs since we're now indexing into arrays.
-          let InputComponent = Custom?.[key.join('.')];
-          if (!InputComponent) {
-            // Select.
-            if (options) {
-              return (
-                <div key={name} role='none' className={padding}>
-                  <SelectInput
-                    type={type}
-                    format={format}
-                    property={name}
-                    disabled={readonly}
-                    label={label}
-                    options={options.map((option) => ({ value: option, label: String(option) }))}
-                    placeholder={placeholder}
-                    {...inputProps}
-                  />
-                </div>
-              );
-            }
-
-            InputComponent = getInputComponent<T>(type, format);
-
-            // TODO(ZaymonFC): Array handling is inelegant. We need to push this complexity down into SDK/Schema.
-            if (array) {
-              return (
-                <ArrayField
-                  key={name}
-                  name={name}
-                  type={type}
-                  array={true}
-                  label={label}
-                  ast={ast}
-                  values={values}
-                  format={format}
-                  readonly={readonly}
-                  placeholder={placeholder}
-                  inputProps={inputProps}
-                  Custom={Custom}
-                />
-              );
-            }
-          }
-
-          if (!InputComponent) {
-            // Recursively render form.
-            if (type === 'object') {
-              const baseNode = findNode(ast, isDiscriminatedUnion);
-              const typeLiteral = baseNode
-                ? getDiscriminatedType(baseNode, values[name] as any)
-                : findNode(ast, AST.isTypeLiteral);
-
-              if (typeLiteral) {
-                const schema = S.make(typeLiteral);
-                return (
-                  <div key={name} role='none'>
-                    <div className={padding}>{label}</div>
-                    <Form<any>
-                      schema={schema}
-                      path={key}
-                      values={values[name] ?? {}}
-                      onValuesChanged={(childValues) => {
-                        inputProps.onValueChange(name, 'object', childValues);
-                      }}
-                      Custom={Custom as any}
-                    />
-                  </div>
-                );
-              }
-            }
-
-            log('no renderer for property', { name, type });
-            return null;
-          }
-
-          return (
-            <div key={name} role='none' className={padding}>
-              <InputComponent
-                type={type}
-                format={format}
-                property={name}
-                disabled={readonly}
-                label={label}
-                placeholder={placeholder}
-                {...inputProps}
-              />
-            </div>
-          );
-        })
-        .filter(isNotFalsy)}
-      {(onCancel || onSave) && !autoSave && (
-        <FormActions onCancel={onCancel} onSubmit={handleSave} canSubmit={canSave} readonly={readonly} />
-      )}
-    </div>
-  );
-};
-
-type ArrayFieldProps<T extends BaseObject> = {
-  name: PropertyKey<T>;
-  type: SimpleType;
-  array: true;
-  label: string;
-  ast: AST.AST;
-  values: Record<string, any>;
-  format?: FormatEnum;
-  readonly?: boolean;
-  placeholder?: string;
-  inputProps: Pick<FormHandler<T>, 'getStatus' | 'getValue' | 'onValueChange' | 'onBlur'>;
-  Custom?: Partial<Record<string, InputComponent<T>>>;
-};
-
-const ArrayField = <T extends BaseObject>({
-  name,
-  type,
-  label,
-  ast,
-  values,
-  format,
-  readonly,
-  placeholder,
-  inputProps,
-  Custom,
-}: ArrayFieldProps<T>) => {
-  const { t } = useTranslation(translationKey);
-  const arrayValues = (values[name] ?? []) as any[];
-  const key = [name];
-
-  // TODO(ZaymonFC): Should this unwrapping happen at a lower level?
-  const tupleType = findNode(ast, AST.isTupleType);
-  const elementType = (tupleType as AST.TupleType | undefined)?.rest[0]?.type;
-
-  if (type === 'object' && elementType) {
-    const baseNode = findNode(elementType, isDiscriminatedUnion);
-    const typeLiteral = baseNode
-      ? getDiscriminatedType(baseNode, values[name] as any)
-      : findNode(elementType, AST.isTypeLiteral);
-
-    if (typeLiteral) {
-      const schema = S.make(typeLiteral);
-
-      return (
-        <div key={name} role='none' className={mx(padding)}>
-          <InputHeader>{label}</InputHeader>
-          <div role='none' className='flex flex-col gap-1'>
-            {arrayValues.map((value, index) => {
-              return (
-                <div key={index} role='none' className='flex items-center gap-1'>
-                  <div role='none' className='flex-1'>
-                    <Form<any>
-                      schema={schema}
-                      path={[...key, index.toString()]}
-                      values={value}
-                      onValuesChanged={(childValues) => {
-                        const newValues = [...arrayValues];
-                        newValues[index] = childValues;
-                        inputProps.onValueChange(name, 'object', newValues);
-                      }}
-                      Custom={Custom as any}
-                    />
-                  </div>
-                  <IconButton
-                    icon='ph--trash--regular'
-                    iconOnly
-                    label={t('button remove')}
-                    onClick={() => {
-                      const newValues = arrayValues.filter((_, i) => i !== index);
-                      inputProps.onValueChange(name, type, newValues);
-                    }}
-                  />
-                </div>
-              );
-            })}
-          </div>
-          <div role='none' className='flex justify-between items-center plb-1'>
-            <IconButton
-              icon='ph--plus--regular'
-              iconOnly
-              label={t('button add')}
-              onClick={() => {
-                const newValues = [...arrayValues, {}];
-                inputProps.onValueChange(name, type, newValues);
-              }}
-            />
-          </div>
-        </div>
-      );
-    }
-    return (
-      <div key={name} role='none'>
-        Nested form not supported in arrays, yet.
-      </div>
-    );
-  }
-
-  const InputComponent = getInputComponent<T>(type, format);
-  if (!InputComponent) {
-    return null;
-  }
-
-  return (
-    <div role='none' key='meta-input' className={mx(padding)}>
-      <InputHeader>{label}</InputHeader>
-      <div role='none' className='flex flex-col gap-1'>
-        {arrayValues.map((_, index) => (
-          <div key={index} role='none' className='flex items-start gap-1'>
-            <div role='none' className='flex-1'>
-              <InputComponent
-                type={type}
-                format={format}
-                label={label}
-                inputOnly
-                property={`${name}.${index}`}
-                disabled={readonly}
-                placeholder={placeholder}
-                {...inputProps}
-              />
-            </div>
-            <IconButton
-              icon='ph--trash--regular'
-              iconOnly
-              label={t('button remove')}
-              onClick={() => {
-                const newValues = arrayValues.filter((_, i) => i !== index);
-                inputProps.onValueChange(name, type, newValues);
-              }}
-            />
-          </div>
-        ))}
-      </div>
-      <div role='none' className='flex justify-between items-center plb-1'>
-        <IconButton
-          icon='ph--plus--regular'
-          iconOnly
-          label={t('button add')}
-          onClick={() => {
-            const newValues = [...arrayValues, SimpleType.getDefaultValue(type)];
-            inputProps.onValueChange(name, type, newValues);
-          }}
+    <FormProvider
+      schema={schema}
+      initialValues={initialValues}
+      onValuesChanged={onValuesChanged}
+      onValidate={onValidate}
+      onValid={onValid}
+      onSave={onSave}
+    >
+      {/* TODO(burdon): Remove padding. */}
+      <div role='none' className={mx('p-2', classNames)} data-testid={testId}>
+        <FormFields
+          schema={schema}
+          path={path}
+          readonly={readonly}
+          filter={filter}
+          sort={sort}
+          lookupComponent={lookupComponent}
+          Custom={Custom}
         />
+        {(onCancel || onSave) && !autoSave && <FormActions onCancel={onCancel} readonly={readonly} />}
       </div>
-    </div>
-  );
-};
-
-type FormActionsProps = {
-  readonly?: boolean;
-  canSubmit: boolean;
-  onCancel?: () => void;
-  onSubmit: () => void;
-};
-
-export const FormActions = ({ onCancel, onSubmit, canSubmit, readonly }: FormActionsProps) => {
-  const { t } = useTranslation(translationKey);
-
-  return (
-    <div role='none' className='flex justify-center'>
-      <div role='none' className={mx(onCancel && !readonly && 'grid grid-cols-2 gap-2')}>
-        {onCancel && !readonly && (
-          <IconButton data-testid='cancel-button' icon='ph--x--regular' label={t('button cancel')} onClick={onCancel} />
-        )}
-        {onSubmit && (
-          <IconButton
-            type='submit'
-            data-testid='save-button'
-            disabled={!canSubmit}
-            icon='ph--check--regular'
-            label={t('button save')}
-            onClick={onSubmit}
-          />
-        )}
-      </div>
-    </div>
+    </FormProvider>
   );
 };

package/src/components/Form/FormActions.tsx

@@ -0,0 +1,41 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import React from 'react';
+
+import { IconButton, useTranslation } from '@dxos/react-ui';
+import { mx } from '@dxos/react-ui-theme';
+
+import { useFormContext } from './FormContext';
+import { translationKey } from '../../translations';
+
+export type FormActionsProps = {
+  readonly?: boolean;
+  onCancel?: () => void;
+};
+
+export const FormActions = ({ onCancel, readonly }: FormActionsProps) => {
+  const { t } = useTranslation(translationKey);
+  const { canSave, handleSave } = useFormContext();
+
+  return (
+    <div role='none' className='flex justify-center'>
+      <div role='none' className={mx(onCancel && !readonly && 'grid grid-cols-2 gap-2')}>
+        {onCancel && !readonly && (
+          <IconButton data-testid='cancel-button' icon='ph--x--regular' label={t('button cancel')} onClick={onCancel} />
+        )}
+        {handleSave && (
+          <IconButton
+            type='submit'
+            data-testid='save-button'
+            disabled={!canSave}
+            icon='ph--check--regular'
+            label={t('button save')}
+            onClick={handleSave}
+          />
+        )}
+      </div>
+    </div>
+  );
+};