@ilife-tech/react-application-flow-renderer 1.0.9 → 1.0.11

package/README.md

@@ -315,7 +315,7 @@ function App() {
           questionGroups,
           pageRules: Array.isArray(rawPageRules) ? rawPageRules : [],
           pageRuleGroup:
-            rawPageRuleGroup && typeof rawPageRuleGroup === 'object' ? rawPageRuleGroup : {},
+            Array.isArray(rawPageRuleGroup) ? rawPageRuleGroup : [],
           validationSchema: validationErrors,
           actionSchema: actionButtons,
           sectionSchema: sectionList || [],
@@ -787,7 +787,7 @@ The `DynamicForm` component accepts the following props:
 | `theme`            | `Object`   | No       | `{}`    | Theme customization                              |
 | `validationSchema` | `Array`    | No       | `[]`    | Additional validation rules                      |
 | `pageRules`        | `Array`    | No       | `[]`    | Page rules for conditional logic                 |
-| `pageRuleGroup`    | `Object`   | No       | `{}`    | Page rule groups with nested conditions          |
+| `pageRuleGroup`    | `Array`    | No       | `[]`    | Page rule groups with complex boolean expressions |
 | `debug`            | `Boolean`  | No       | `false` | Enable debug mode                                |
 | `formApiRef`       | `Object`   | No       | -       | Ref object to access form API methods            |
 | `toastConfig`      | `Object`   | No       | `{}`    | Toast configuration                              |
@@ -908,6 +908,76 @@ The package supports a wide range of field types to handle various input require
 | `button`         | `ButtonField`         | Action button field                                        |
 | `spinner`        | `SpinnerField`        | Loading indicator field                                    |
 
+## Conditional Logic
+
+The Dynamic Form Renderer provides powerful conditional logic capabilities through the `pageRules` and `pageRuleGroup` props.
+
+### PageRules
+
+Page rules define individual conditions and actions for dynamic form behavior:
+
+```javascript
+const pageRules = [
+  {
+    ruleId: "rule1",
+    triggerQuestionIds: ["101"],
+    comparison: "equals",
+    compareValue: "yes",
+    action: "showquestion",
+    targetQuestionIds: ["201"]
+  },
+  // more rules...
+];
+```
+
+### Enhanced PageRuleGroup
+
+The enhanced `pageRuleGroup` feature provides sophisticated boolean expressions for complex conditional logic:
+
+```javascript
+// New array-based format with complex boolean expressions
+const pageRuleGroup = [
+  {
+    questionId: "40374",
+    evaluationExpression: "rule1 AND rule2"
+  },
+  {
+    questionId: "40555",
+    evaluationExpression: "(rule1 AND rule2) OR rule3"
+  }
+];
+```
+
+#### Key Features
+
+- **Complex Boolean Logic**: Combine multiple rules with AND/OR operations
+- **Parentheses Support**: Control operator precedence for complex evaluations
+- **Backward Compatibility**: Supports legacy object-based format
+
+#### Expression Syntax
+
+- **Operators**: `AND`, `OR` (case-insensitive)
+- **Rule References**: Use `ruleId` values from the pageRules array
+- **Parentheses**: Group expressions to control evaluation order
+
+#### Examples
+
+```javascript
+// Simple AND condition
+{
+  questionId: "40374",
+  evaluationExpression: "rule1 AND rule2"
+}
+
+// Complex nested conditions
+{
+  questionId: "40890",
+  evaluationExpression: "(rule1 AND rule2) OR (rule3 AND rule4)"
+}
+```
+
+For detailed documentation on the enhanced pageRuleGroup feature, see the [PageRuleGroupEnhancement.md](docs/PageRuleGroupImplementation/PageRuleGroupEnhancement.md) file.
+
 ## Advanced Configuration
 
 ### Toast Notifications