react-form-dto 1.0.0 → 1.0.2

package/README.md

@@ -38,6 +38,7 @@ It operates at a higher abstraction level where **layout, validation, rendering,
 - 🧩 **Extensible renderers** – plug in custom components
 - 🛡️ **Strong TypeScript typing** – safe, predictable APIs
 - 🚀 **Enterprise-ready** – optimized for large, config-driven forms
+- 🔎 **Nested condition engine** – combine AND/OR groups for powerful, multi‑field visibility rules
 
 ---
 
@@ -92,6 +93,12 @@ pnpm add react-form-dto
 
 ---
 
+## Release Notes
+
+See [CHANGELOG.md](./.github/CHANGELOG.md) for detailed version history.
+
+---
+
 ## Core Concepts
 
 ### DTO as Source of Truth
@@ -267,6 +274,30 @@ const profileForm: FormDTO = {
 
 ---
 
+## 🎭 Conditional Visibility with `visibleWhen`
+
+React Form DTO supports dynamic field visibility based on the values of other fields in the form. This is achieved through the `visibleWhen` property, which allows you to define simple conditions or complex logical expressions.
+
+### Basic Usage
+
+Show a field only when another field has a specific value:
+
+```tsx
+{
+  id: "partnerName",
+  type: "text",
+  label: "Partner Name",
+  visibleWhen: {
+    field: "maritalStatus",
+    equals: "married"
+  }
+}
+```
+
+For detail documentation, please visit [Docs](https://shakir-afridi.github.io/react-form-dto/docs/api/visibleWhen.html)
+
+---
+
 ## 🌍 Internationalization (I18n)
 
 React Form DTO has built-in support for multi-language forms through `I18String` and `I18nOption` types.

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { FormBuilder, Section, Field, TextAreaInput, AutoCompleteField, MultiAutoCompleteField, RadioInput, SelectInput, TextInput, CheckBoxInput, } from './components';
 export { validateAll, validateField, validationRules } from './utils';
-export type { FieldDTO, SectionDTO, FormDTO, InputType, Validations, } from './types';
+export type { FieldDTO, SectionDTO, FormDTO, InputType, Validations, Condition as VisibleWhenCondition, FieldCondition as VisibleWhenFieldCondition, ConditionGroup as VisibleWhenConditionGroup, } from './types';
 export { useFormBuilder } from './hooks';