# RSpade Framework - Breaking Changes

This document tracks breaking changes in the RSpade framework that require developers to update their application code.

## Format

Each breaking change entry includes:
- **Date**: When the change was introduced
- **Component**: Affected system/component
- **Change**: Description of what changed
- **Migration**: How to update existing code
- **Impact**: Severity (Critical/High/Medium/Low)

---

## 2025-11-03: Rsx_Form Automatic Submit Button Wiring

**Component**: `Rsx_Form` component
**Impact**: Medium - Requires manual code updates to existing forms

### Change

Rsx_Form now automatically wires all submit buttons (`button[type="submit"]`) to call the form's `submit()` method. Manual button wiring is no longer needed and should be removed.

### Previous Pattern

```javascript
class Frontend_Clients_Edit {
    static init() {
        // Wire save button to Rsx_Form component
        $('#save-btn').on('click', function() {
            const $form = $('.Rsx_Form').first();
            const form_component = $form.component();
            if (form_component) {
                form_component.submit();
            }
        });
    }
}
```

```blade
<button type="button" class="btn btn-primary" id="save-btn">
    Save Changes
</button>
```

### New Pattern

```javascript
class Frontend_Clients_Edit {
    static init() {
        // No initialization needed - submit button automatically wired by Rsx_Form
    }
}
```

```blade
<button type="submit" class="btn btn-primary">
    Save Changes
</button>
```

### Migration Steps

1. **Update button markup**:
   - Change `type="button"` to `type="submit"`
   - Remove `id` attribute if only used for wiring

2. **Remove manual wiring code**:
   - Delete the `$('#save-btn').on('click', ...)` handler
   - If your init() function is now empty, you can leave it (it may be needed in the future) or add a comment explaining it's for future use

3. **Test form submission**:
   - Verify the form still submits correctly
   - Check validation error handling still works

### Benefits

- Less boilerplate code
- More semantic HTML (`type="submit"`)
- Consistent pattern across all forms
- Automatic event prevention (no need for `e.preventDefault()`)

### Notes

- This change only affects forms using the `Rsx_Form` component
- Custom submit logic (pre-submission validation, etc.) should now be handled differently - contact framework maintainer for patterns
- Forms with multiple submit buttons (e.g., "Save" vs "Save and Continue") will have all buttons wired - differentiate using button values or data attributes

---

## Template for Future Entries

```
## YYYY-MM-DD: Brief Description

**Component**: Affected component/system
**Impact**: Critical/High/Medium/Low

### Change
Description of what changed and why.

### Previous Pattern
[Code example showing old way]

### New Pattern
[Code example showing new way]

### Migration Steps
1. Step one
2. Step two
3. Step three

### Benefits
- Benefit one
- Benefit two

### Notes
Additional context or edge cases.
```