@ilife-tech/react-application-flow-renderer 1.0.19 → 1.0.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -16,6 +16,7 @@ A powerful and flexible React package for rendering dynamic forms with advanced
16
16
  - [Props Reference](#props-reference)
17
17
  - [Field Types](#field-types)
18
18
  - [Advanced Configuration](#advanced-configuration)
19
+ - [Performance & Engine Options](#performance--engine-options)
19
20
  - [Troubleshooting](#troubleshooting)
20
21
  - [Examples & Best Practices](#examples--best-practices)
21
22
 
@@ -1130,6 +1131,38 @@ For detailed documentation on the enhanced pageRuleGroup feature, see the [PageR
1130
1131
 
1131
1132
  ## Advanced Configuration
1132
1133
 
1134
+ ## Performance & Engine Options
1135
+
1136
+ When using the provider-level API, you can tune performance and engine behavior.
1137
+
1138
+ ### FormProvider props
1139
+
1140
+ - `performanceConfig`
1141
+ - `debounceDelayMs: number` (default: 120) – Debounce for textual input processing
1142
+
1143
+ - `engineOptions`
1144
+ - `enablePerActionGating: boolean` (default: true) – Toggle per-action gating via questionRules
1145
+ - `maxEvaluationDepth: number` (default: 20) – Reflexive evaluation depth guard
1146
+
1147
+ ### Example
1148
+
1149
+ ```jsx
1150
+ import { FormProvider } from '@ilife-tech/react-application-flow-renderer/context/FormContext';
1151
+ import DynamicFormInner from '@ilife-tech/react-application-flow-renderer/src/components/core/components/DynamicFormInner';
1152
+
1153
+ <FormProvider
1154
+ formSchema={questionGroups}
1155
+ questionRuleDetails={questionRuleDetails}
1156
+ questionRules={questionRules}
1157
+ performanceConfig={{ debounceDelayMs: 150 }}
1158
+ engineOptions={{ enablePerActionGating: true, maxEvaluationDepth: 20 }}
1159
+ >
1160
+ <DynamicFormInner schema={questionGroups} actionSchema={actionSchema} onSubmit={handleSubmit} />
1161
+ </FormProvider>;
1162
+ ```
1163
+
1164
+ Note: The top-level `DynamicForm` abstraction may not expose these knobs directly. Use `FormProvider` for fine-grained control.
1165
+
1133
1166
  ### Toast Notifications
1134
1167
 
1135
1168
  The Dynamic Form Renderer uses react-toastify for displaying notifications such as error messages, warnings, and success confirmations.