@reformer/core 1.1.0-beta.2 → 1.1.0-beta.3

package/llms.txt

@@ -345,19 +345,57 @@ form.items.push({ id: '1', name: 'Item' }); // Array operations
 
 ## 9. ARRAY SCHEMA FORMAT
 
+**Array items are sub-forms!** Each array element is a complete sub-form with its own fields, validation, and behavior.
+
 ```typescript
 // ✅ CORRECT - use tuple format for arrays
-const schema = {
-  items: [itemSchema] as [typeof itemSchema],
-  properties: [propertySchema] as [typeof propertySchema],
+// The template item defines the sub-form schema for each array element
+const itemSchema = {
+  id: { value: '', component: Input },
+  name: { value: '', component: Input },
+  price: { value: 0, component: Input, componentProps: { type: 'number' } },
+};
+
+const schema: FormSchema<MyForm> = {
+  items: [itemSchema],  // Array of sub-forms
 };
 
+// Each array item is a GroupNode (sub-form) with its own controls:
+form.items.map((item) => {
+  // item is a sub-form (GroupNode) - access fields like nested form
+  item.name.setValue('New Name');
+  item.price.value.value;  // Get current value
+});
+```
+
+```typescript
 // ❌ WRONG - object format is NOT supported
 const schema = {
   items: { schema: itemSchema, initialItems: [] }, // This will NOT work
 };
 ```
 
+### Array Item as Sub-Form
+
+```typescript
+// Validation for array items (each item is a sub-form)
+validateItems(path.items, (itemPath) => {
+  // itemPath provides paths to sub-form fields
+  required(itemPath.name);
+  min(itemPath.price, 0);
+});
+
+// Render array items - each item is a sub-form
+{form.items.map((item, index) => (
+  <div key={item.id}>
+    {/* item is a sub-form - use FormField for each field */}
+    <FormField control={item.name} />
+    <FormField control={item.price} />
+    <button onClick={() => form.items.removeAt(index)}>Remove</button>
+  </div>
+))}
+```
+
 ## 10. ASYNC WATCHFIELD (CRITICALLY IMPORTANT)
 
 ```typescript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reformer/core",
-  "version": "1.1.0-beta.2",
+  "version": "1.1.0-beta.3",
   "description": "Reactive form state management library for React with signals-based architecture",
   "type": "module",
   "main": "./dist/index.js",