PromucFlow_constructor/app/client/src/widgets/JSONFormWidget/constants.ts
ashit-rath 32fee08c5c
feat: JSON Form widget (#8472)
* initial layout

* updated parser to support nested array

* array field rendering

* changes

* ts fix

* minor revert FormWidget

* modified schema structure

* select and switch fields

* added checkbox field

* added RadioGroupField

* partial DateField and defaults, typing refactoring

* added label and field type change

* minor ts changes

* changes

* modified widget/utils for nested panelConfig, modified schema to object approach

* array/object label support

* hide field configuration when children not present

* added tooltip

* field visibility option

* disabled state

* upgraded tslib, form initial values

* custom field configuration - add/hide/edit

* field configuration - label change

* return input when field configuration reaches max depth

* minor changes

* form - scroll, fixedfooter, enitity defn and other minior changes

* form title

* unregister on unmount

* fixes

* zero state

* fix field padding

* patched updating form values, removed linting warnings

* configured action buttons

* minor fix

* minor change

* property pane - sort fields in field configuration

* refactor include all properties

* checkbox properties

* date properties

* refactor typings and radio group properties

* switch, multselect, select, array, object properties

* minor changes

* default value

* ts fixes

* checkbox field properties implementation

* date field prop implementation

* switch field

* select field and fix deep nested meta properties

* multiselect implementation

* minor change

* input field implementation

* fix position jump on field type change

* initial accordian

* field state property and auto-complete of JSONFormComputeControl

* merge fixes

* renamed FormBuilder to JSONForm

* source data validation minor change

* custom field default value fix

* Editable keys for custom field

* minor fixes

* replaced useFieldArray with custom logic, added widget icon

* array and object accordian with border/background styling

* minor change

* disabled states for array and objects

* default value minor fix

* form level styles

* modified logic for isDisabled for array and object, added disabledWhenInvalid, exposed isValid to fieldState for text input, removed useDisableChildren

* added isValid for all field types

* fixed reset to default values

* debounce form values update

* minor change

* minor change

* fix crash - source data change multi-select to array, fix crash - change of options

* fix positioning

* detect date type in source data

* fix crash - when object is passed to regex input field

* fixed default sourceData path for fields

* accodion keep children mounted on collapse

* jest test for schemaParser

* widget/helper and useRegisterFieldInvalid test

* tests for property config helper and generatePanelPropertyConfig

* fix input field validation not appearing

* fix date field type detection

* rename data -> formData

* handle null/undefined field value change in sourceData

* added null/undefined as valid values for defaultValue text field

* auto detect email field

* set formData default value on initial load

* switch field inline positioning

* field margin fix for row direction

* select full width

* fiex date field default value - out of range

* fix any field type to array

* array default value logic change

* base cypress test changes

* initial json form render cy test

* key sanitization

* fix fieldState update logic

* required design, object/array background color, accordion changes, fix - add new custom field

* minor change

* cypress tests

* fix date formatted value, field state cypress test

* cypress - field properties test and fixes

* rename test file

* fix accessort change to blank value, cypress tests

* fix array field default value for modified accessor

* minor fix

* added animate loading

* fix empty state, add new custom field

* test data fix

* fix warnings

* fix timePrecision visibility

* button styling

* ported input v2

* fix jest tests

* fix cypress tests

* perf changes

* perf improvement

* added comments

* multiselect changes

* input field perf refactor

* array field, object field refactor performance

* checkbox field refactor

* refectored date, radio, select and switch

* fixes

* test fixes

* fixes

* minor fix

* rename field renderer

* remove tracked fieldRenderer field

* cypress test fixes

* cypress changes

* array default value fixes

* arrayfield passedDefaultValue

* auto enabled JS mode for few properties, reverted swith and date property controls

* cypress changes

* added widget sniping mode and fixed object passedDefaultValue

* multiselect v2

* select v2

* fix jest tests

* test fixes

* field limit

* rename field type dropdown texts

* field type changes fixes

* jest fixes

* loading state submit button

* default source data for new widget

* modify limit message

* multiseelct default value changes and cypress fix

* select default value

* keep default value intact on field type change

* TextTable cypress text fix

* review changes

* fixed footer changes

* collapse styles section by default

* fixed footer changes

* form modes

* custom field key rentention

* fixed footer fix in view mode

* non ascii characters

* fix meta merge in dataTreeWidget

* minor fixes

* rename useRegisterFieldInvalid.ts -> useRegisterFieldValidity.ts

* modified dependency injection into evaluated values

* refactored fixedfooter logic

* minor change

* accessor update

* minor change

* fixes

* QA fixes date field, scroll content

* fix phone number field, removed visiblity option from array item

* fix sourceData autocomplete

* reset logic

* fix multiselect reset

* form values hydration on widget drag

* code review changes

* reverted order of merge dataTreeWidget

* fixes

* added button titles, fixed hydration issue

* default value fixes

* upgraded react hook form, modified array-level/field-level default value logic

* fixed select validation

* added icon entity explorer, modified icon align control

* modify accessor validation for mongo db _id

* update email field regex

* review changes

* explicitly handle empty source data validation
2022-03-24 12:43:25 +05:30

278 lines
8.7 KiB
TypeScript

import { ControllerRenderProps } from "react-hook-form/dist/types/controller";
import { InputType } from "widgets/InputWidget/constants";
import {
ArrayField,
CheckboxField,
CurrencyInputField,
DateField,
InputField,
MultiSelectField,
ObjectField,
PhoneInputField,
RadioGroupField,
SelectField,
SwitchField,
} from "./fields";
import { TextSize } from "constants/WidgetConstants";
// CAUTION! When changing the enum value, make sure any direct comparison
// eg fieldType === "Array" instead of fieldType === FieldType.ARRAY is taking place
// and modified accordingly
export enum FieldType {
ARRAY = "Array",
CHECKBOX = "Checkbox",
CURRENCY_INPUT = "Currency Input",
DATEPICKER = "Datepicker",
EMAIL_INPUT = "Email Input",
MULTISELECT = "Multiselect",
MULTILINE_TEXT_INPUT = "Multiline Text Input",
NUMBER_INPUT = "Number Input",
OBJECT = "Object",
PASSWORD_INPUT = "Password Input",
PHONE_NUMBER_INPUT = "Phone Number Input",
RADIO_GROUP = "Radio Group",
SELECT = "Select",
SWITCH = "Switch",
TEXT_INPUT = "Text Input",
}
export enum DataType {
STRING = "string",
NUMBER = "number",
ARRAY = "array",
BOOLEAN = "boolean",
OBJECT = "object",
BIGINT = "bigint",
SYMBOL = "symbol",
UNDEFINED = "undefined",
NULL = "null",
FUNCTION = "function",
}
export type Obj = Record<string, any>;
export type JSON = Obj | Obj[];
export type FieldComponentBaseProps = {
defaultValue?: string | number;
isDisabled: boolean;
isRequired?: boolean;
isVisible: boolean;
label: string;
labelStyle?: string;
labelTextColor?: string;
labelTextSize?: TextSize;
tooltip?: string;
};
export type FieldEventProps = {
onFocus?: string;
onBlur?: string;
};
export type BaseFieldComponentProps<TProps = any> = {
hideLabel?: boolean;
isRootField?: boolean;
fieldClassName: string;
name: ControllerRenderProps["name"];
propertyPath: string;
passedDefaultValue?: unknown;
schemaItem: SchemaItem & TProps;
};
export type Schema = Record<string, SchemaItem>;
/**
* dataType - result of "typeof value" -> string/number/boolean etc.
* fieldType - the field component that this represents -> Text/Switch/Email etc.
* sourceData - the data that is used to compute initial dataType and fieldType.
* isCustomField - this is set to true only for fields created using the "Add new field" in Property Pane
* name - this is a sanitized value used to identify a field uniquely -> firstName, age etc.
* position - a number from 0..n specifying the order in a form.
* originalIdentifier - This is derived from the sourceData key, in it's unsanitized form.
* It is used as a marker to identify this field in the sourceData to detect any change. As the actual
* identifier used can be modified during sanitization process.
* identifier - This is derived from the sourceData key, in it's sanitized form. This acts as a marker
* in the schema and helps identifying from nested property changes.
* accessor - This is very similar to the name property. This is directly exposed in the property pane to be
* modified at free will. It acts as a staging state for the name, as name cannot have invalid values. So
* when accessor is updated, it checks if this value can be used as name and then updates it, else keeps the
* name property intact for data sanity.
*/
export type SchemaItem = FieldComponentBaseProps & {
accessor: string;
children: Schema;
dataType: DataType;
fieldType: FieldType;
identifier: string;
isCustomField: boolean;
originalIdentifier: string;
position: number;
sourceData: any;
};
export type ComponentDefaultValuesFnProps<TSourceData = any> = {
sourceDataPath?: string;
fieldType: FieldType;
bindingTemplate: {
suffixTemplate: string;
prefixTemplate: string;
};
isCustomField: boolean;
sourceData: TSourceData;
skipDefaultValueProcessing: boolean;
};
// This defines a react component with componentDefaultValues property attached to it.
export type FieldComponent = {
(props: BaseFieldComponentProps): JSX.Element | null;
componentDefaultValues?:
| FieldComponentBaseProps
| ((props: ComponentDefaultValuesFnProps) => FieldComponentBaseProps);
isValidType?: (value: any, options?: any) => boolean;
};
export type FieldState<TObj> =
| {
[k: string]: TObj | TObj[] | FieldState<TObj> | FieldState<TObj>[];
}
| FieldState<TObj>[]
| TObj;
export type HookResponse =
| Array<{ propertyPath: string; propertyValue: any }>
| undefined;
export const ARRAY_ITEM_KEY = "__array_item__";
export const ROOT_SCHEMA_KEY = "__root_schema__";
export const MAX_ALLOWED_FIELDS = 50;
export const RESTRICTED_KEYS = [ARRAY_ITEM_KEY, ROOT_SCHEMA_KEY];
export const FIELD_MAP: Record<FieldType, FieldComponent> = {
[FieldType.ARRAY]: ArrayField,
[FieldType.CHECKBOX]: CheckboxField,
[FieldType.CURRENCY_INPUT]: CurrencyInputField,
[FieldType.DATEPICKER]: DateField,
[FieldType.EMAIL_INPUT]: InputField,
[FieldType.MULTISELECT]: MultiSelectField,
[FieldType.MULTILINE_TEXT_INPUT]: InputField,
[FieldType.NUMBER_INPUT]: InputField,
[FieldType.OBJECT]: ObjectField,
[FieldType.PASSWORD_INPUT]: InputField,
[FieldType.PHONE_NUMBER_INPUT]: PhoneInputField,
[FieldType.RADIO_GROUP]: RadioGroupField,
[FieldType.SELECT]: SelectField,
[FieldType.SWITCH]: SwitchField,
[FieldType.TEXT_INPUT]: InputField,
};
export const INPUT_TYPES = [
FieldType.CURRENCY_INPUT,
FieldType.EMAIL_INPUT,
FieldType.MULTILINE_TEXT_INPUT,
FieldType.NUMBER_INPUT,
FieldType.PASSWORD_INPUT,
FieldType.PHONE_NUMBER_INPUT,
FieldType.TEXT_INPUT,
] as const;
/**
* This translates FieldType to Input component inputType
* As InputField would handle all the below types (Text/Number), this map
* would help use identify what inputType it is based on the FieldType.
*/
export const INPUT_FIELD_TYPE: Record<typeof INPUT_TYPES[number], InputType> = {
[FieldType.CURRENCY_INPUT]: "CURRENCY",
[FieldType.EMAIL_INPUT]: "EMAIL",
[FieldType.NUMBER_INPUT]: "NUMBER",
[FieldType.PASSWORD_INPUT]: "PASSWORD",
[FieldType.PHONE_NUMBER_INPUT]: "PHONE_NUMBER",
[FieldType.TEXT_INPUT]: "TEXT",
[FieldType.MULTILINE_TEXT_INPUT]: "TEXT",
};
export const FIELD_EXPECTING_OPTIONS = [
FieldType.MULTISELECT,
FieldType.RADIO_GROUP,
FieldType.SELECT,
];
export const DATA_TYPE_POTENTIAL_FIELD = {
[DataType.STRING]: FieldType.TEXT_INPUT,
[DataType.BOOLEAN]: FieldType.SWITCH,
[DataType.NUMBER]: FieldType.NUMBER_INPUT,
[DataType.BIGINT]: FieldType.NUMBER_INPUT,
[DataType.SYMBOL]: FieldType.TEXT_INPUT,
[DataType.UNDEFINED]: FieldType.TEXT_INPUT,
[DataType.NULL]: FieldType.TEXT_INPUT,
[DataType.OBJECT]: FieldType.OBJECT,
[DataType.ARRAY]: FieldType.ARRAY,
[DataType.FUNCTION]: FieldType.TEXT_INPUT,
};
// The potential value here is just for representation i.e it won't be used to set default value anywhere.
// This will just help to transform a field type (when modified in custom field) to appropriate schemaItem
// using schemaParser.
export const FIELD_TYPE_TO_POTENTIAL_DATA: Record<FieldType, any> = {
[FieldType.ARRAY]: [{ firstField: "" }],
[FieldType.CHECKBOX]: true,
[FieldType.CURRENCY_INPUT]: "",
[FieldType.DATEPICKER]: "",
[FieldType.EMAIL_INPUT]: "",
[FieldType.MULTISELECT]: [],
[FieldType.MULTILINE_TEXT_INPUT]: "",
[FieldType.NUMBER_INPUT]: 0,
[FieldType.OBJECT]: {},
[FieldType.PASSWORD_INPUT]: "",
[FieldType.PHONE_NUMBER_INPUT]: "",
[FieldType.RADIO_GROUP]: "",
[FieldType.SELECT]: "",
[FieldType.SWITCH]: true,
[FieldType.TEXT_INPUT]: "",
};
export const FIELD_SUPPORTING_FOCUS_EVENTS = [
FieldType.CHECKBOX,
FieldType.CURRENCY_INPUT,
FieldType.DATEPICKER,
FieldType.EMAIL_INPUT,
FieldType.MULTISELECT,
FieldType.MULTILINE_TEXT_INPUT,
FieldType.NUMBER_INPUT,
FieldType.PASSWORD_INPUT,
FieldType.PHONE_NUMBER_INPUT,
FieldType.TEXT_INPUT,
];
// These are the fields who's defaultValue property control's JS
// mode would be enabled by default.
export const AUTO_JS_ENABLED_FIELDS: Record<
FieldType,
(keyof SchemaItem)[] | null
> = {
[FieldType.DATEPICKER]: ["defaultValue"],
[FieldType.SWITCH]: ["defaultValue"],
[FieldType.ARRAY]: null,
[FieldType.CHECKBOX]: ["defaultValue"],
[FieldType.CURRENCY_INPUT]: null,
[FieldType.EMAIL_INPUT]: null,
[FieldType.MULTISELECT]: null,
[FieldType.MULTILINE_TEXT_INPUT]: null,
[FieldType.NUMBER_INPUT]: null,
[FieldType.OBJECT]: null,
[FieldType.PASSWORD_INPUT]: null,
[FieldType.PHONE_NUMBER_INPUT]: null,
[FieldType.RADIO_GROUP]: null,
[FieldType.SELECT]: null,
[FieldType.TEXT_INPUT]: null,
};
export const getBindingTemplate = (widgetName: string) => {
const prefixTemplate = `{{((sourceData, formData, fieldState) => (`;
const suffixTemplate = `))(${widgetName}.sourceData, ${widgetName}.formData, ${widgetName}.fieldState)}}`;
return { prefixTemplate, suffixTemplate };
};